Skip to main content

Magic Leap 2

The Magic Leap 2 build delivers an optimized rendering pipeline, controller bindings, and localization heuristics for Lumin OS. It is available exclusively to Enterprise customers.

Enterprise Access​

  • Request activation via support@web-ar.studio with your Magic Leap organization ID and intended deployment timeline.
  • After approval, you receive:
    • A private UPM registry URL that exposes the com.webarvps.vps.ml2 package.
    • Side-loadable .zip archives that contain preconfigured Lumin projects and sample scenes.
    • A deployment checklist covering certificate management, spatial permission prompts, and controller gestures.

Enterprise only: The Magic Leap 2 adapters, shaders, and map streaming plugins are not bundled with the public SDK.

Prerequisites​

  • Magic Leap 2 (Lumin OS 1.4.0 or newer).
  • Magic Leap Hub with the ml2 Unity extensions.
  • Unity 2022.3 LTS + Universal Render Pipeline (URP) profile.
  • WebAR³ VPS API key with maps published for indoor use. Acquire keys via space.web-ar.studio or email support@webar3.com / support@web-ar.studio.

Setup Steps​

  1. Add the Enterprise package feed to your Unity project's Packages/manifest.json: 
    {
      "scopedRegistries": [
        {
          "name": "WebAR³ Enterprise",
          "url": "https://packages.web-ar.studio/enterprise-registry",
          "scopes": [
            "com.webarvps.vps",
            "com.webarvps.vps.ml2"
          ]
        }
      ]
    }
  2. Install the Magic Leap 2 support package via Package Manager.
  3. Switch platform to Lumin (File → Build Settings → Lumin) and import the example scene Assets/WebARStudio/MagicLeap2/Scenes/SpatialLocalization.unity.
  4. Update localization settings on the VPSLocalisationService component:
    • Enable Fails Count To Reset = 3.
    • Set Localization Timeout = 1.5.
    • Assign your Magic Leap specific map IDs.
  5. Build & deploy using Magic Leap Hub. During the first launch, grant camera, depth, and meshing permissions.

Testing Checklist​

  • Validate VPS acquisition indoors (recommended minimum 120 lux).
  • Confirm controller trigger toggles the localization HUD overlay.
  • Use the included PoseDiagnostics prefab to monitor drift and re-localization events.
  • Run the sample Spatial Anchors scene if you rely on meshing data.

Support​

Enterprise accounts gain a dedicated Slack channel with WebAR³ solutions engineers for troubleshooting Lumin OS patches, firmware regressions, or custom viewer requirements.